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1. Introduction 
Welcome to Apache Logs Viewer, the free tool that will help you analyze and monitor your apache or IIS 
log files. Apache Logs Viewer has a number of features which makes it quite a powerful tool, namely 
Filters, Search functionality, Reports and Statistics. Throughout this manual each of these features will 
be explained in detail so that you can get the most out of Apache Logs Viewer. 


Eile Edit Reports Statistics Help 


Ey El El |S : Filter Status: |» ~ | IP Address: | Ea | All ~ | “Apply Filter fl | “Yr ¿Dl 

Advanced Filter Date: | Request: |» User Agent: |» Referer | User: Ja Sort Sort > U 93 
ahnar_access.log EI] hyper_access.log E| main_access.log E9){ main_error.log [J 

IP Address Date Request Stat... Size Country Referer a 
157.55.33.113 7/29/2013 12:23:30 AM GET / HTTP/1.1 200 3759 United States - 

66.249.72.135 7/29/2013 12:47:30 AM GET /sshots/mainmenu.png HTTP/1.1 304 0 United States 

203.176.183.196 7/29/2013 1:12:09 AM GET /nyperBkreport pdf HTTP/1.0 200 1529968 Indonesia http://hyperiannet.org/ 
184.154.115.4 7/29/2013 1:42:38 AM GET /hyperBkreport pdf HTTP/1.1 200 1529968 United States  http://hyper.iannet.org/ 
50.115.170.108 7/29/2013 1:56:44 AM GET /hyperBkreport pdf HTTP/1.0 200 1529968 United States http://hyper iannet.org/ 
200.109.228.67 7/29/2013 3:09:42 AM GET /hyperBkreport pdf HTTP/1.0 200 1529968 Venezuela  http://hyper.iannet.org/ 
198.46.144.22 7/29/2013 3:11:24 AM GET /hyperBkreport pdf HTTP/1.0 200 1529968 United States http://hyper.iannet.org/ 
108.178.10.18 7/29/2013 3:24:07 AM GET /hyperBkreport.pdf HTTP/1.1 200 1529968 United States  http://hyper.iannet.org/ 
198.143.143.29 7/29/2013 3:57:39 AM GET /hyperBkreport pdf HTTP/1.0 200 1529968 United States  http://hyper.iannet.org/ 
178.255.215.72 7/29/2013 5:06:51 AM GET /robots.bt HTTP/1.1 200 66 France - 

178.255.215.72 7/29/2013 5:06:51 AM GET /home.html HTTP/1.1 200 6832 France - 

125.39.66.153 7/29/2013 5:29:12 AM GET /hyperBkreport pdf HTTP/1.1 200 1529968 China http://hyper.iannet.org/ 
211.244.83.215 7/29/2013 6:13:17 AM GET /robots.bd HTTP/1.1 200 66 Korea, Republic of http://search.daum.net/ 
211.244.83.215 7/29/2013 6:13:18 AM GET /HTTP/1.1 200 3759 Korea, Republic of http://search.daum.net/ 
211.244.83.215 7/29/2013 6:13:19 AM GET /home html HTTP/1.1 200 6832 Korea, Republic of http://search.daum.net/ 
176.31.83.172 7/29/2013 6:36:25 AM GET /hyperBkreport.pdf HTTP/1.1 200 1529968 France  http://hyper.iannet.org/ 
66.249.72.135 7/29/2013 7:40:17 AM GET / HTTP/1.1 200 3759 United States 

123.125.71.69 7/29/2013 7:48:06 AM GET /HTTP/1.1 200 3759 China 

220.181.108.161 7/29/2013 7:48:52 AM GET / HTTP/1.1 200 3759 China - 

221.11.67.115 7/29/2013 8:05:42 AM GET /hyperBkreport pdf HTTP/1.1 200 1529968 China http://hyper.iannet.org/ 
79.114.103.109 7/29/2013 8:40:40 AM GET /nyperBkreport pdf HTTP/1.1 200 1529968 Romania http://hyper.iannet.org/ 
66.249.72.135 7/29/2013 10:59:49 AM GET /sshots/mainmenu.png tmb HTTP/1.1 304 0 United States - 

37.59.179.232 7/29/2013 11:29:53 AM GET /hyperBkreport.pdf HTTP/1.1 200 1529968 France http://hyperiannet.org/ 
208.115.111.75 7/29/2013 11:42:45 AM GET /robots.bt HTTP/1.1 200 66 United States - 

157.55.33.113 7/29/2013 11:44:30 AM GET /robots bt HTTP/1.1 200 66 United States 

157.55.33.113 7/29/2013 11:51:09 AM GET / HTTP/1.1 200 3759 United States - 

72.225.47.26 7/29/2013 12:14:16 PM GET /hyperBkreport pdf HTTP/1.1 200 1529968 United States  http://hyper.iannet.org/ 
192.119.151.131 7/29/2013 12:34:56 PM GET /hyperBkreport pdf HTTP/1.0 200 1529968 United States http://hyper.iannet.org/ 
198.27.82.151 7/29/2013 12:36:17 PM GET /robots bt HTTP/1.1 200 66 Canada 

198.27.82.151 7/29/2013 12:36:18 PM GET / HTTP/1.1 200 3759 Canada 

198.27.82.151 7/29/2013 12:36:18 PM GET Aaviconico HTTP/1.1 200 2238 Canada 

198.27.82.151 7/29/2013 12:36:18 PM GET /appletouchicon png HTTP/1.1 404 218 Canada 

208.115.111.75 7/29/2013 12:53:48 PM GET Alock/ HTTP/1.1 200 5147 United States 

66.248.202.64 7/29/2013 1:04:22 PM GET /hyperBkreport pdf HTTP/1.0 200 1529968 Canada  http://hyper.iannet.org/ 
94.23.164.207 7/29/2013 1:45:00 PM GET /hyperBkreport pdf HTTP/1.1 200 1529968 Germany http://hyper.iannet.org/ v 
< > 
Update Completed 09:00:06 [No Filter] Donate iannet ..: 


Figure 1 Apache Log Viewer Main Window 


2. Installation 
Apache Logs Viewer can be installed on any Windows system provided that you have Microsoft .NET 
Framework v3.5 or later installed (http://www.microsoft.com/net). This is already installed on Windows 
Vista/2008, Windows 7/8 and later. On systems such as Windows XP and Windows 2003 you need to 
download it and manually install it before you can continue with the Apache Logs Viewer installation. 


If you are unsure if this is already installed the setup will prompt you and open the website for you to 
download this component from Microsoft website. 


Hardware Requirements: 


e 1(GHz) or faster 32-bit (x86) or 64-bit (x64) processor 
e 512 MB RAM or more 
e 35 MB available hard disk space 
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To complete the installation please follow the setup and press Finish to finalize the installation. Once 
done you can open Apache Logs Viewer from the start menu. 


3. Using Apache Logs Viewer 


3.1 Apache Log Files 
There are two types of Apache Log files: access and error logs. Apache Log Viewer is used to analyze the 
access log files since they contain the most important information, i.e. client requests to the web server. 


Access logs are normally formatted in two common ways: Common and Combined. Below you can see 
detailed information on each log format and what data it contains. 


e Common log format 


This log format includes the basic information that is required to identify the host and the 
request. Itis normally displayed as this: 


eh %1 %u %t \"%r\" %>s %b 


%h IP Address of client (remote host) 

VA Identd of client (normally unavailable) 
%u User id of user requesting object 

%t Time of request 

%r Full request string 

%>s Status code 

%b Size of request (excluding headers) 


e Combined log format 


This log format contains the information available in the common log format but it also includes 
the referrer information and the browser information. 


ah %1 %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\" 


%{Referer}i The previous webpage 
%{User-agent}i The Client’s browser 


Apache Logs Viewer accepts both of these log formats. To add a new log file click the Add log button 
from the main toolbar this can be seen below. 


BEBE 
Figure 2 Main Toolbar 


This toolbar has 4 buttons the Add Access log button, Add Error log button, the Split Log button and the 
Find Button. 
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3.1.1 Open Apache Access Log File 
When you open a new log from the ‘Add Access Log’ button in the main toolbar you can select what log 
format you should use. 


Choose the log format Please referto the Webserver configuration f unsure. 
(8) Combined (Contains Browser and Referrer Information) 
LogFormat "%h Yi Yu %t \"%r\" %>s %b \"%{Refereri\" \"%{User-Agent}i\"" combined 


(©) Common (default) 
LogFormat "%h Yi Xu Yi \"%r\" %>s %b" common 


O w3c 


© Other LogFormat "%v %h % %u Xt NAA" %>s Xb" 


2 © Custom (beta) LogFormat "%h %4 %u © \"%r\" %>s %b" common 


Read All file and update in real time. 
Read only date range that falls with the below range. 


2/9012 
{2013 


Figure 3 Add Access Log - Selecting the Log Format 


The window shown above will be shown after you select the log file. In the top section you can choose 
the format (common/combined). If common is selected than it is assumed that the log file does not 
contain referrer and user agent information. On the other hand if combined is selected than the log file 
would contain referrer and user agent information. 


Several other custom (yet popular) formats are listed in the Other drop down section. If your custom 
LogFormat is not shown here you can type the custom log format in the Custom section. This would be 
obtained from the httpd.conf file of your server. 


If common is selected and the log file is in combined format Apache Log Viewer will still load the file 
correctly but the referrer and user agent information will be missing. 


In the bottom section you can specify if the whole file will be read or just a section of it. This is 
particularly useful if the log is very large. Specify the date range and Apache Logs Viewer will load only 
that part. 


Note: You can add even log files that are in use by the apache server, making Apache Logs Viewer ideal 
to monitor the log file in real time and generate real time data on the fly. 
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3.1.2 Open Apache Error Log File 

Another type of Apache log file is the error log file. This file will contain errors that apache will meet 
while servicing requests. In most cases a line in the error log will have the equivalent entry in the access 
log. 


Choose the log format Please referto the Webserver configuration f unsure. 


@ Apache 2.2x 
© Apache 2.4x 


Figure 4 Selecting Error Log Format 


In Apache 2.4 onwards the error log format has changed. The above dialog box allows you to select the 
type of error file that you have. 


3.1.3 Open IIS Access Log File 
IIS (Microsoft Internet Information Services) uses two common formats, both of which are supported by 
Apache Logs Viewer. These are the: 


e NCSA format 
e \W3C format 


Please refer to your IIS configuration to determine which format you have. The NCSA format is the 
identical to the Apache Logs Viewer Common format. 


3.1.4 Open Nginx Access Log File 
Nginx (engine x) stores log files in the format shown below. To open a log stored by nginx select Custom 
and enter the below line from the Open Access Log Options dialog. 


LogFormat "%h %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" nginx 


3.1.5 Appending a Log 

Some situations can arise where you would want to concatenate multiple logs into one view. This is 
possible using the Append Log function. To append a log to the existing one visible simply click on the 
Append Log function from the File menu and follow the instructions similar to when adding a new log. 
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3.2 Log Lines 
When you open a log file the log will be read and each entry will be displayed in the Apache Logs Viewer 
window. 


Log lines are identified by a distinct color depending on the status code for access log files and error 
codes for error log files. The default colors are shown below. These can be changed from the settings 
panel. 


Access Log Lines Colors: 


Color Status Code Description 
Grey 100 - 199 Informational 
Blue 200 - 299 Successful 
Green 300 - 399 Redirection 
Red 400 - 499 Client Error 
Orange 500 - 599 Server Error 
Error Log Lines Colors: 

Color Error Description 

Red Emergency 

Orange Warning 

Dark Red Alert 

Violet Notice 

Light Violet Critical 

Green Information 

Dark Red Error 

Black Debug 


3.3 Log File Split 

If a log file is very large then it is possible to split it up into smaller files to make processing easier. Once 
split, the files on disk can be opened individually in Apache Logs Viewer. The original file is left intact as 
new files are always created. 


You can split both access and error logs using any of the following two methods: 


e bysize 
e by time (days or months) 
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Split the following log into smaller files for easier processing. 
C:\Users\lan\Desktop ‘ta 1 bt 


Split Log Criteria 


@ By Size 


Figure 5 Split Log File Options Window 


To split a file click on the 'Split Log File' button in the toolbar and select the file to split. Then you will be 
prompted with the window shown above so as to select the split parameters. Click on Split to start the 
file split operation. The resultant files will be found in the same directory where the original file is. 


3.4 Filters 

Apache Logs Viewer lets you filter either by IP Address, by Status code, by Request type or a 
combination. Start by selecting a status code from the drop down list. You can either select a specific 
code or else you can select a range of codes denoted by two subsequent ‘xx’ like 4xx which will match all 
401 and 404 errors. At the end of the list there is also a specific code named ‘none’ which will match all 
codes. 


Filter Status: | ~ | IP Address: |» Er | All ~ | “g Apply Filter ¿y | “pr 


Figure 6 Filter toolbar 


Then select the inclusion list for the status code. If you want to include the status code then you would 
select to ‘Include’ otherwise you would select the ‘Exclude’ from the drop down list. When in include 
mode the status box will be highlighted as green while the exclude will highlight it as red. The white 
indicates that the status criteria will be ignored. 


I Include 
a| Exclude 
ani 


Ignore 


Figure 7 Menu to Include, Exclude or Ignore particular filter criteria 
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The same would apply for the IP Address. You would select an ‘Include’, ‘Exclude’ or ‘Ignore’ from the 
drop down and enter the IP Address. IP Addresses can be delimited by a semi-colon ‘;’ thus you can filter 
by multiple IP Addresses. You can also compute a set of IP Addresses quickly by clicking on the ‘Get IP 
Addresses....’ button. 


The Request type can be set to filter the type of requests you want i.e. GET, HEAD, POST, or else All 
request types. 


Filter Status: $- BRITE Tee |~|| P Address: El | all > | Sg Apply Filter fy | Y- 


Figure 8 Filter toolbar to include both Status code and IP Address 


The above filter configuration will match all not found/moved i.e. 301, 302, 303, 304 errors and all IP 
addresses (since the IP Address field is blank). This has a similar effect as leaving the IP Address to 
‘Ignore’ mode. 


> To apply the filter click on the ‘Apply Filter’ button. This will apply the filter on the visible list. 


Once that the filter has been activated you can export the list to a CSV, for more analysis. You can also 
select one of the statistics (described below). To return to the full list click on the Clear button to disable 
any filter that is active. 


3.4.1 Advanced Filtering 

Advanced Filtering? is used in conjunction with the filters listed in the previous section. With advanced 
filtering you can either filter by request, User-Agent , User and or by referrer. The advanced filter can be 
either active or inactive and it can be in include or exclude mode. These criteria can be specified 
through the Advanced Filter toolbar shown below. 


Advanced Filter Request: | User Agent: |» Referer: |v 


Figure 9 Advanced Filter - Active in Include mode 


To include/exclude specific criteria enter something in the respective text box. If a text box is left empty 
then this is not taken into account. To filter the items according to this filter use the button found on the 
Filter toolbar (Figure 9). It is possible to include or exclude the criteria of the advanced filter, simply set 
the filter criteria to Include, Exclude or Ignore respectively as per (Figure 7). 


Advanced Filter Request: |» User Agent: x |v Firefox Referer: hr google.com © 


Figure 10 Exclude User Agent, Include Referer 


1 (Note that the Advanced Filter is only available in the unlocked versions of Apache Logs Viewer. See section 5 — 
Unlocking. ) 
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In the figure above the Advanced Filter will exclude all items that have ‘Firefox’ in the User-Agent header 
and have ‘google.com’ in the Referrer URL. (It will also consider the criteria specified in the Basic Filter — 
not shown here.) 


3.5 Sorting 

Sorting is available from the sort toolbar shown in Figure 11. You can sort on any of the available fields. 
Simply select the requested field by clicking on the Sort drop down button. Once the desired column has 
been selected, click on the ASC (ascending) or DSC (descending) buttons to apply the sort. 


Sort Sort ~- fé SI 


Figure 11 Sort Toolbar 


You can also combine a Filter with the sort functionality. First apply the required filter and the sort the 
list using any column as the sorting order. 


3.6 Search 
In Apache Log Viewer you can search for a particular request. The find dialog box (see Figure 12) can be 
used to lookup a particular line using one of the criteria found in the table below. 


Search Column Criteria 

Request Part of 

Date Exact, Greater of Less match (no time) 
IP Address First part 

Referrer Exact match 


When searching for a request, all requests which contain the criteria (at any position) will be matched. 
The IP Address on the other hand will be matched from the start. Thus if you need to look for an IP 
address that ranges from 192.168.12.0 to 192.168.12.255 you will enter 192.168.12. The referrer will 
need to match exactly (ignoring case). 


Once that the criteria has been specified you can click on Find to find the first item. Then you can either 
select Find All to find all lines that match the particular criteria entered or Find Next... (or press F3) to 
find the next matching line. 
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Request [ ] exact match 
GET /robots. txt| 


C] Date Equal 
Saturday . August 3,2013 


C] Referer [V] exact match 


O UserAgent [Y] exact mate 


Figure 12 Find Dialog Box 


Once that some items are selected you can easily export them from Apache Log Viewer to a number of 
different formats (see below). 


3.7 Export 

The export function can be used to export log lines from Apache Log Viewer to various file formats. This 
is particularly useful if you need to import the data into another program such as a spreadsheet for 
further analysis. 


You can export the entire list or just the selected items such as after a search (using Find All). The 
following file formats are supported: Text file (.txt), Comma Separated Value (.csv), HTML file (.html) or 
Log file (.log). 


Exporting is simple just click on Export List to export the entire list or Export Selected to export just he 
selected items. Specify the filename and click on save to save the file to disk. 


3.8 Reports 

There are two main kinds of reports: pie/bar charts and maps. These give you a visual representation of 
the data in the log file. There are two modes for the Reports set from the Preferences section (Reports 
Scope): 


1. Visible List 


Using this mode of operation the report data is generated from what's visible in the list. This 
means that any active filters will be taken into account. Thus if you want to generate the 
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Status Codes per Day report but you want to leave the 4xx errors out of the report first you 


filter the list to omit Axx status codes and then you generate the Status Codes per Day 


report which will consist of a bar chart with 404 status codes omitted. 


2. All List 


The reports work on the log file in whole and enabled filters don’t have any effects on the 


reports. 


For bar/pie charts once the report is generated you can either Print or Export. The export functionality 


lets you either export to Microsoft Excel Workbook or else to an Adobe PDF document. For maps you 


can save to a BMP, JPEG, GIF or PNG file. 


The available reports, their type and a description on each report are shown in the table below. 


Report Name Type Description 
UserAgent 
User Agent Pie Hits from a particular User Agent 
Desktop Browser (hits) Pie Hits originating from desktop browsers 
Mobile Browser (hits) Pie Hits originating from mobile browsers 
By Request (hits) Pie Hits from a particular browser 
requesting a specific request 
By Country (hits) Pie Hits from a particular browser 
originating for a specific country 
Hits Each Column Hits per day 
Day 
Visits by Country 
Visits by Country Pie Hits and the originating country 
Visits by Country (Reduced) Pie Similar as Visits by Country but only 
displays a selection of the top countries 
Visits by Region Pie Hits and the originating region - North 
America, South America, Europe, Africa, 
Asia & Pacific 
Browsers 
Desktop Browsers Pie Unique hits originating from the 
traditional desktop browsers 
Mobile Browsers Pie Unique hits originating from mobile 
browsers 
Desktop vs Mobile Pie Unique hits showing total traditional 
desktop vs mobile browser 
By Request Pie Unique hits from a particular browser 
requesting a specific request 
By Country Pie Unique hits from a particular browser 
originating for a specific country 
Vists (Hits) 
Visits by IP Column Hits from a particular IP Address 
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Visits by Referrer 
Visits by Request 
Visits from Country 


Visits by UserAgent 


Visits by User 
Visits (Unique Hits) 
Unique Hits 
Unique Hits (Bots Excluded) 
Unique Hits (start date) 


Visits by IP 

Visits by Referrer 
Visits by Request 
Visits from Country 
Visits by UserAgent 
Visits by IP & Request 


Visits by Request €: UserAgent 


Visits by Country €: Request 


Visits by User 
Hits per Hour 

Any 

From IP 


From User 
For Request 


For Request (substring) 


Hits Each 
Hits each Month 
Hits each Week 
Bot Hits 
IPv6 
IPv6 per Day 
IPv6 per Day (Unique) 
IP 


Top IP Hits per Day 
Top Error IP Hits per Day 


IP Hits per Day 


Column 
Column 
Column 


Column 


Column 


Column 
Column 
Column 


Column 
Column 
Column 
Column 
Column 
Column 


Column 


Column 


Column 


Column 
Column 


Column 
Column 


Column 


Column 
Column 
Column 


Column 
Column 


Stacked Column 
Stacked Column 


Stacked Column 


Hits originating from a particular referer 
Hits originating for a particular request 
Hits originating from a particular 
country 

Hits originating from a particular user 
agent 

Hits originating from a particular user 


Unique hits per day 

Unique hits per day but excluding bots 
Unique hits per day but only from a 
particular date onwards 

Unique hits from a particular IP Address 
Unique hits from a particular referrer 
Unique hits for a particular request 
Unique hits from a particular country 
Unique hits from a particular user agent 
Unique hits from a particular IP Address 
for a particular request 

Unique hits from a particular request 
and a particular user agent 

Unique hits from a particular country 
and for a particular request 

Unique hits from a particular user 


Hits per Hour for a particular day 

Hits per Hour from a particular IP 
Address 

Hits from a particular user 

Hits per Hour for a particular request in 
a particular day 

Similar as above but takes part ofthe 
request 


Number of hits in a particular month 
Number of hits aggregated per week 
Hits from Bots 


Hits from an IP version 6 address 
Unique hits from an IP version 6 address 


Top IP Addresses per day 

Top IP Addresses resulting in Axx status 
codes per day 

Particular IP Addresses requesting 
requests per day 
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Requests 
Request Analysis 


Top Requests per Day 
Top Error Requests per Day 
Requests per Day 


Requests & Average 
TimeTaken 


Traffic Sources 
Geo Country Visits 
Geo Country Visits (start date) 


Search Visits 
Search Visits 


Search Terms per Day 


Spider Visits 
Status Codes 

Status Code 

Status Codes per Day 
Users 

Users per Day 


Users and Average TimeTaken 


Operating System 


Bandwidth 
Bandwidth 


Bandwidth by Type 
File Types per Day 


Referrers per Day 


Pie 


Stacked Column 


Stacked Column 


Stacked Column 


Bar 


Pie 


Map 


Map 


Stacked Column 


Column 


Pie 
Stacked Column 


Pie 


Line 


Stacked Column 


Stacked Column 


Stacked Column 


Shows which parts of the website were 
accessed and by what percentage. 
Shows which requests are the most 
requested (popular) 

Shows which requests result in 4xx 
status codes 

Shows number of fetches for a set of 
requests 

Shows request and average time taken 
to serve requests (must have time taken 
data in log) 

Shows referrer source i.e. Direct, 
Referrer or Search Engine 

Shows graphical map with intensity of 
visits 

Shows graphical map with intensity of 
visits but after a specific date 


Shows request that came from search 
visits 

Shows terms that have been used in 
search terms per day 

Shows number of visits from spider bots 


Shows percentage of status codes 
Shows number of status codes per day 


Shows percentage of each operating 
system used to visit 


Shows total bandwidth used to serve 
hits 

Shows bandwidth count for particular 
file types on a per day basis 

Shows total hits for specific file types on 
specific days 

Shows referers on a per day basis 


Note: Most reports are only available with a valid unlock code. (see Unlocking). These reports are disabled (greyed out) in the 


free version of Apache Logs Viewer. 


Note: Hits vs. Unique Hits 
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The difference between hits and unique hits is that a hit is a single request to the web server. A web 
page can consist of multiple hits from the same IP Address over a period of time. On the other hand a 
unique hit is grouping of hits from an IP Address during that day. Thus if a client request a page using 5 
different hits in the same day then they would be counted as only one. 


© | aa im» | WholePage ~ 


EB Other - 17.67578% 
GG Android - 2.148438% 
BEE Chrome - 6.640625% 
MN Internet Explorer - 13.28125% 
E Baiduspider - 6.25% 
MN Googlebot - 10.44922% 
E Firefox - 31.05469% 
EEE Opera - 1.171875% 
EN Safari - 1.171875% 
HB iPhone - 0.2929688% 
Cp Yandex - 9.863281% 


Figure 13 User Agents Report 
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i [A Copy Save |@ Close, 


Figure 14 Geo Country Visits Report 


3.9 Statistics 

Statistics give a numerical representation for number of criteria. Unlike reports statistics work either on 
the log file as a whole or else on the visible log including any enabled filters (see Preferences section for 
more info about this). 


The statistics available can be found in the table below. Some statistics prompt for a start date when to 
start counting as can be seen below. 


Name Start Date Description 

Hits M Hits (number of requests) each day 

Status Codes M Count of status code each day 

Bandwidth M Total bandwidth per day 

Top IP Addresses [x] The IP Addresses which made the most number of hits 

Top Error IP Addresses M IP Addresses which caused 404 errors 

Top Requests [x] The Requests that were requested most 

Top Countries [x] The Countries that made the most number of hits 

Top 404 URLs M The most frequent 404 URLs 

Top Referrers [x] The most frequent referrers 

Top User Agents x] The most popular User Agents found in log file. 

Bot IP Addresses [x] The whole set of IP Addresses of bots (identified from requests to 
robots.txt) 

Country IP Addresses [x] The whole set of IP Addresses from a particular country 

Error IP Addresses [x] List of IP Addresses which had a hit which resulted in a 4xx or 5xx 
status code. 

Unique IP Addresses M List of unique IP addresses 

Unique Request M List of unique requests 

Unique Referrer M List of unique referrers 

Unique User-Agent M List of unique user agent strings 
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File Types M The file types requested 

Referrer Visits ix] The visits from referrers 

Referrer Hotlinking ix] Visits from referrers which requested a media type. 
Search Terms ix] Terms/keywords used in searches (from referrer data) 
Visit Count M Count of Visits from the same IP Address 

IPv4 vs IPv6 M The number of IPv4 and IPv6 hits per day 


3.10 Refresh Toolbar 
The refresh toolbar is used to enable or disable the automatic refresh functionality and the automatic 
scrolling. 


Figure 15 Refresh Toolbar 


These features are particularly useful when the log file is being written to by the apache server and the 
log file is being analyzed in real time. The third button forces ALV to refresh the log, similar to pressing 
F5. 


3.11 Command Line Arguments 
The following command line arguments can be used when calling Apache Logs Viewer: 


Argument Description 

/lowmem Start Apache Logs Viewer in low memory mode to 
reduce the memory usage. 

/tray Minimize Apache Logs Viewer to the tray on 
startup. 

VAR, Display the supported command line arguments 
and exit. 

/default Restores default configuration and starts ALV. This 


is particularly useful if ALV is taking too long to 
start up due to a very large log file. 
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4. 


Preferences 


You can change some of Apache Logs Viewer settings from the Preferences Dialog Page. This dialog is 


accessible from Edit...Preferences. 


General 


Reports 


Auto Monitor on startup — Tick if you want ALV to start monitoring files when ALV is opened. 


Truncate Large Logs — Tick if you want to read only the last part of the log file. The size is 
specified in KB in the adjacent box. 


Enable Auto Refresh — Tick to enable refreshing of the list automatically when new lines are 
added (for realtime viewing) 


Scroll to the last entry on refresh — Tick if you want to scroll to the last entry when the log file is 
refreshed. You can also set the refresh timeout in the textbox beneath. 


Reports Scope — Change the scope you want to be used for your reports. The scope can be on 
the whole list (no filters) or else it can be on the visible list (ie taking into consideration any 
enabled filters.) 


Statistics 


Colors 


Statistics Top Number - Set the value which will be used when optioning the top statistics. The 
default value is 10. 


Statistics Scope — Change the scope you want to be used in your statistics. The scope can be on 
the whole list (no filters) or else it can take into consideration any enabled filters. 


HTTP Status Code Colors - Set the colors for each different status code. 


Error Log Codes - Set the colors for the different error codes in the error log. 


Columns 


Select the columns that you want to display for each log. 


Apache Logs Viewer always saves a backup copy of your settings in case they get lost or corrupted. This 


file is saved in %appdata%\apachelogsview 
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5. Unlocking 
Apache Log Viewer has some features (some reports and statistics) which are disabled by default. To 
enable such features you require a unique unlock code. Please note that you can still use Apache Log 
Viewer without an unlock code. Apache Logs Viewer is free and will remain free. 


An unlock code can be obtained by donating €12 for individuals, or €40 for Companies/Corporations on 
PayPal. Please follow the links either in the Apache Logs Viewer window or this link 


http://www.apacheviewer.com/donate.php. All payments/donations will be used to continue 


maintaining Apache Logs Viewer. 


Once the payment has been received a unique unlock code will be emailed to you which will be valid for 
any future updates to the version. You can enter the unlock code from the Help menu. 


6. Support 


If you have any queries or suggestions for Apache Logs Viewer please leave your feedback on 


http://www.apacheviewer.com/contactus.php. All your suggestions / queries are welcome. 


Similarly if your log format is not supported by Apache Logs Viewer, let us know and we will try to add it. 
You should submit the LogFormat directive of the Apache configuration file and a sample log file would 
be appreciated. 


Information in this document is subject to change without notice. 


No part of this document may be reproduced and transmitted in any form or by any means, electronic or 
mechanical, for any purpose, without the express written permission of iannet. 


Apache Logs Viewer was developed by iannet 
This product includes GeoLite data created by MaxMind, available from http://www.maxmind.com 


Apache Logs Viewer is copyright of iannet. © 2006-2014 iannet.org. All rights reserved. 
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